home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.2 / IRIX 6.2 CD2.iso / dist / outbox.idb / usr / relnotes / Outbox / ch2.z / ch2
Text File  |  1996-06-10  |  8KB  |  265 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        2.  _I_n_s_t_a_l_l_a_t_i_o_n__I_n_f_o_r_m_a_t_i_o_n
  9.  
  10.        This chapter lists supplemental information to the _I_R_I_S
  11.        _S_o_f_t_w_a_r_e _I_n_s_t_a_l_l_a_t_i_o_n _G_u_i_d_e.  The information listed here is
  12.        product- and release-specific; use it with the Installation
  13.        Guide to install this product.
  14.  
  15.        2.1  _O_u_t__B_o_x__S_u_b_s_y_s_t_e_m_s
  16.  
  17.        Mindshare Out Box includes these subsystems:
  18.  
  19.        _o_u_t_b_o_x._s_w._o_u_t_b_o_x              The Software that allows you
  20.                                      to publish files.
  21.  
  22.        _o_u_t_b_o_x._s_w._w_e_b_d_i_s_t             The Webdist software that
  23.                                      allows you to setup software
  24.                                      installation pages.  This
  25.                                      subsystem is also compatible
  26.                                      with the Netscape Server
  27.                                      software.
  28.  
  29.        _o_u_t_b_o_x._b_o_o_k_s._O_u_t_b_o_x_H_e_l_p       Help documentation with the
  30.                                      above software.
  31.  
  32.        _w_e_b_s_e_r_v_e_r._s_w._w_e_b_s_e_r_v_e_r        An HTTP/1.0 compliant Web
  33.                                      Server including support for
  34.                                      CGI-bin, ISMAPS, and server
  35.                                      parsed HTML.
  36.  
  37.  
  38.        2.2  _I_n_s_t_a_l_l_a_t_i_o_n__M_e_t_h_o_d
  39.  
  40.        After installation of this software, the system must be
  41.        rebooted.
  42.  
  43.        2.3  _P_r_e_r_e_q_u_i_s_i_t_e_s
  44.  
  45.        This software requires IRIX 5.3 or IRIX 6.1
  46.  
  47.        2.4  _N_e_t_s_c_a_p_e _S_e_r_v_e_r _a_n_d _O_u_t_b_o_x _I_n_s_t_a_l_l_a_t_i_o_n _a_n_d
  48.             _C_o_n_f_i_g_u_r_a_t_i_o_n _I_n_f_o_r_m_a_t_i_o_n
  49.  
  50.        This section has instructions for the following:
  51.  
  52.  
  53.           +o Running Outbox with the Netscape 1.12 Communications
  54.             server (2.4.1 below).
  55.  
  56.           +o Running Outbox with other releases of the Netscape
  57.             Communications server (2.4.2 below).
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.        2.4.1  _R_u_n_n_i_n_g__O_u_t_b_o_x__w_i_t_h__t_h_e__N_e_t_s_c_a_p_e__1_._1_2__s_e_r_v_e_r_.  Outbox
  75.        requires a specific configuration of a Web Server to work
  76.        correctly.  When the Netscape server is installed on a clean
  77.        system (one not previously running the Netscape server), it
  78.        is automatically configured to run with Outbox. However, to
  79.        prevent breaking older installations of the Netscape server,
  80.        upgrading to Netscape 1.12 will NOT configure the Netscape
  81.        server to work with Outbox. There are two choices for such
  82.        systems:
  83.  
  84.  
  85.           +o Do not do anything. In this case, Outbox will not run.
  86.             This is harmless, your Netscape Communications Server
  87.             1.12 will continue to work. However, Outbox, webdist,
  88.             WhatsNew and future SGI products relying on a web
  89.             server with a document root of "/var/www/htdocs" will
  90.             not work.
  91.  
  92.           +o Configure the Netscape server to run Outbox. This
  93.             configuration is complex and best accomplished by doing
  94.             a clean install of the Netscape server (instructions
  95.             (2.4.1.1 below)).  Doing such an install WILL
  96.             TEMPORARITLY BREAK PREVIOUSLY EXISTING WEBSITES UNTIL
  97.             YOU MIGRATE ALL EXISTING DOCUMENTS TO THE NEW
  98.             CONFIGURATION OF THE NETSCAPE SERVER. Do not do this if
  99.             your server is set up in a multi-hosting configuration
  100.             or if you have relocated the server root.
  101.  
  102.  
  103.        2.4.1.1  _D_o_i_n_g _a _c_l_e_a_n _i_n_s_t_a_l_l _o_f _t_h_e _N_e_t_s_c_a_p_e _1._1_2
  104.        _C_o_m_m_u_n_i_c_a_t_i_o_n_s _s_e_r_v_e_r  This operation will BREAK PREVIOUSLY
  105.        EXISTING WEB SITES. See the information above before doing
  106.        this.
  107.  
  108.  
  109.           +o Become root by typing "su" (and entering the root
  110.             password if any).
  111.  
  112.           +o In a shell type "versions remove ns_http netsite"
  113.  
  114.           +o In a shell type "rm -r /usr/ns-home/httpd-80/config/"
  115.  
  116.           +o Install the Netscape Communications 1.12 server using
  117.             swmgr(1) or inst(1).
  118.  
  119.  
  120.        2.4.2  _R_u_n_n_i_n_g _O_u_t_b_o_x _w_i_t_h _o_t_h_e_r _r_e_l_e_a_s_e_s _o_f _t_h_e _N_e_t_s_c_a_p_e
  121.        _s_e_r_v_e_r  Running outbox with other releases of the Netscape
  122.        server is no longer supported. Silicon Graphics recommends
  123.        that you upgrade  to the Netscape Communicastion  1.12
  124.        Server. However, if you wish to configure your Netscape
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.        server to conform, you may do so using the information
  141.        provided below on how Outbox can be made to run with other
  142.        servers.
  143.  
  144.  
  145.        2.5  _R_u_n_n_i_n_g__w_i_t_h__O_t_h_e_r__S_e_r_v_e_r_s
  146.  
  147.        Outbox can run with any HTTP/1.0 compliant web server that
  148.        supports CGI-BIN, server parsed HTML and User Directory
  149.        mappings. If you are running a different web server, other
  150.        than the Netscape Servers from SGI, SGI recommends that you
  151.        upgrade to the server shipped with Outbox and migrate your
  152.        documents to it. To do this see the information below
  153.        (2.5.1).
  154.  
  155.  
  156.        While this is not a supported configuration, you may also
  157.        choose to configure your web server to run Outbox. To do
  158.        this, see the information below (2.5.2).
  159.  
  160.  
  161.        2.5.1  _M_i_g_r_a_t_i_n_g__d_o_c_u_m_e_n_t_s__f_r_o_m__o_t_h_e_r__w_e_b__s_e_r_v_e_r_s_:  The
  162.        Outbox webserver runs with a document root of
  163.        /var/www/htdocs, a cgi-bin directory of /var/www/cgi-bin and
  164.        with user directory of "public_html". You may migrate your
  165.        documents to run with this configuration. Consult the
  166.        documentation of your exisiting Web Server to understand the
  167.        requirements for your existing documents.
  168.  
  169.  
  170.        2.5.2  _R_u_n_n_i_n_g__w_i_t_h__a__d_i_f_f_e_r_e_n_t__w_e_b__s_e_r_v_e_r  If you are
  171.        running a different web server, consult its documentation to
  172.        configure it such that it has a document root of
  173.        /var/www/htdocs, a cgi-bin directory of /var/www/cgi-bin and
  174.        a user directory of "public_html". You must also turn on
  175.        server-parsed HTML for all HTML files (.html suffix) if it
  176.        is turned off.
  177.  
  178.  
  179.        Note:  This is not a supported configuration.
  180.  
  181.  
  182.        2.6  _T_o__t_u_r_n__o_f_f__O_u_t_b_o_x_:
  183.  
  184.        To turn outbox off, for example on a secure system, follow
  185.        the following instructions:
  186.  
  187.  
  188.         1. Open a shell window by choosing "Unix Shell" from the
  189.        Desktop toolchest.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.        2. Log in as root by typing "su" at the shell prompt. Type
  207.        in the root password if you have one.
  208.  
  209.        3. Type "chkconfig outbox off" and reboot your machine.
  210.  
  211.  
  212.        2.7  _S_e_c_u_r_i_t_y__C_o_n_s_i_d_e_r_a_t_i_o_n_s_:
  213.  
  214.        The Outbox and webserver products have the following
  215.        security implications:
  216.  
  217.  
  218.           +o Installation creates a directory with mode 777 (read,
  219.             write and execute priviledge to all users). This
  220.             directory is "/var/www/htdocs". You can change the
  221.             permissions on this directory to be more restrictive.
  222.  
  223.           +o Information about the users, machine configuration and
  224.             some user files are accessible to others on the same
  225.             network.  You can stop this by disabling Outbox
  226.             completely. To do this follow the instructions below:
  227.  
  228.  
  229.        1. Log in as root by typing "su" at the shell prompt. Type
  230.        in the root password if you have one.
  231.  
  232.  
  233.        2. Type "chkconfig outbox off" and reboot your machine.
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.